My Simple Hunter (WoW Classic 20주년 서버 & TBC 호환용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.5 (빌드 20505)
Version: 1.0.0 (2026. 4. 1.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Hunter는 사냥꾼의 상과 덫을 직관적으로 관리하고, 주요 쿨다운, 발동 효과, 디버프 지속시간을 한눈에 파악할 수 있도록 순수 Lua로 가볍게 작성된 사냥꾼 전용 애드온입니다.

■ 현재 접속한 캐릭터가 사냥꾼일 때만 활성화되며, 7개의 상 바와 5개의 덫 바를 독립적으로 배치할 수 있습니다. 또한 죽은척하기 지속시간, 덫 발동 디버프 추적, 전투 중 사냥꾼의 징표 누락 경고 및 각종 스킬의 쿨다운과 특성 발동 상태에 대한 개인 화면 중앙 알림(경보음 포함)을 제공합니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 상 및 덫 관리 바
 - 상 버튼: 7개의 주요 상(매, 독사, 원숭이, 야생, 치타, 치타 무리, 야수)을 가로로 배치하여 클릭으로 즉시 시전합니다. 현재 활성화된 상은 아이콘이 밝게 표시됩니다.
 - 덫 버튼: 5개의 덫(얼음, 냉기, 제물, 폭발, 뱀)과 이동 잠금/해제 토글 버튼을 가로로 배치하고 버튼 하단에 덫 시전 쿨다운(노란색)을, 버튼 아래에 덫 설치 지속시간 카운트다운(흰색)을 직관적으로 표시합니다.
 - 덫 디버프: 적에게 덫(얼음, 냉기, 제물, 폭발, 뱀)이 발동되면 덫 바 오른쪽에 그 아이콘과 지속시간을 표시하며, 종료 5초 전부터는 텍스트 색상이 Cyan에서 Magenta로 변경되어 직관적인 덫 관리가 가능합니다.
 - 독립적 이동: 상 바와 덫 바는 각각 독립적으로 화면 내 원하는 곳으로 드래그하여 배치할 수 있습니다.

■ 화면 중앙 추적기
 - 죽은척하기: 시전 시 화면 중앙 하단에 스킬 아이콘과 함께 남은 지속시간을 분:초 단위로 카운트다운합니다.

■ 전투 및 스킬 알림 (개인 화면 중앙)
 - 쿨다운 종료: 주요 스킬(위협, 야수의 격노, 산탄 사격, 공격 저지, 속사, 죽은척하기, 종족 특성 등)의 쿨다운 종료 전(빨간색) 및 시전 가능 시점(초록색)을 출력합니다.
 - 발동 효과: 신속 사격(매의 상 연마), 역습, 올가미 특성 발동 시에 출력합니다.
 - 사냥꾼의 징표 미유지: 전투 중임에도 어떤 대상에게도 내 사냥꾼의 징표가 안 걸려있다면 출력합니다. 추가로 덫 바 아래에 내 사냥꾼의 징표가 걸린 대상 이름을 출력합니다.
 - 상 주의: 전투에 진입했는데 치타의 상이나 치타 무리의 상이 켜져 있다면 출력합니다.
 - 경보음 재생: 본 애드온 폴더 안에 MSH_RW.ogg 파일이 있으면 우선 재생하고, 없다면 기본 경보음(RaidWarning.ogg)을 재생합니다. 설정 창에서 세부 알림을 개별적으로 켜거나 끌 수 있습니다.

─────────────────────────────
3. 명령어 및 사용 방법
─────────────────────────────
■ 기본 명령어
 - /간단냥꾼 또는 /msh : 설정 창 열기/닫기

■ 화면 중앙 메시지 및 경보음 설정
 - 설정 창에서 ON(RW), ON, OFF로 전체 알림 모드를 변경할 수 있습니다.
 - 징표/정조준, 죽척/섬광, 위협/올가미/역습, 상/덫 등 카테고리별로 체크박스를 통해 세밀하게 켜고 끌 수 있습니다.

■ 위치 이동 및 잠금
 - 덫 바의 6번째 버튼(사냥꾼 직업 아이콘)을 Shift+우클릭하여 상 바와 덫 바의 이동 잠금/해제를 동시에 토글합니다.
 - 잠금 해제 시 드래그하여 두 바를 각각 원하는 위치에 배치한 후 다시 Shift+우클릭하여 고정합니다.

─────────────────────────────
4. 설치 방법
─────────────────────────────
■ 아래와 같은 폴더 구조로 설치하세요.

Interface
└── AddOns
    └── MySimpleHunter
        ├── MySimpleHunter.lua
        ├── MySimpleHunter_Vanilla.toc
        ├── MySimpleHunter_TBC.toc
        ├── README.txt
        └── MSH_RW.ogg (선택 사항 - 커스텀 경보음)

■ 게임 내 '애드온' 탭에서 [My Simple Hunter]가 활성화되어 있는지 확인합니다.

─────────────────────────────
5. 주의 사항 및 팁
─────────────────────────────
■ 사냥꾼 전용: 이 애드온은 사냥꾼 이외의 직업으로 접속하면 동작하지 않습니다.

■ 이동 상태 제한: UI 이동 잠금이 해제된 상태(연녹색 테두리 표시)에서는 좌클릭을 통한 상 변경 및 덫 설치가 작동하지 않으므로, 위치 설정 후 반드시 다시 6번째 버튼을 Shift+우클릭해서 잠가주시기 바랍니다.

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 4. 1.)
 - 사냥꾼 전용 독립형 상 바 및 덫 바 프레임
 - 주요 스킬 쿨다운, 덫 설치 및 디버프 지속시간, 죽은척하기, 발동 효과(신속 사격, 역습, 올가미), 사냥꾼의 징표 누락 추적

─────────────────────────────
7. 저작권 및 이용 조건
─────────────────────────────
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

─────────────────────────────
8. 개발자 정보
─────────────────────────────
■ Author: Goyathlay, 20주년 기념일 펜구스의 흉포 KR 호드

■ Contact: 인게임 우편/디스코드
